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1 Overview 


GroupWise 2012 Support Pack 2 provides enhancements for both administrators and end users. 


For Administrators 


+ Windows Server 2012 is now supported. 


+ The GroupWise/Exchange coexistence solution integrates GroupWise and Exchange to provide 
users of both email systems with unified address book lookups and free/busy calendar 
searching. For setup instructions, see the GroupWise/Exchange Coexistence Guide. 


+ The new role resource type represents a position in an organization that can be reassigned from 
one owner to the next. As owners change, the role resource mailbox retains all information 
associated with the role. Unlike general resources and place resources, role resources are 
included in a Reply to All. 


For End Users 


+ Windows 8 and Internet Explorer 10 are now supported. 


GroupWise 2012 SP2 includes all bug fixes that are available in GroupWise 2012 SP1 and HP1. For a 
list of the bugs that have been fixed in GroupWise 2012 SP2, see the GroupWise 2012 SP2 Bug Fix List. 


For information about the documentation updates that have been made since GroupWise 2012 SP1, 
see Section 17, “GroupWise Documentation,” on page 31. 


2 GroupWise System Requirements 


GroupWise 2012 system requirements are listed in “GroupWise System Requirements” in 
“GroupWise Product Overview” in the GroupWise 2012 Installation Guide. 


3 Linux Installation 


¢ Section 3.1, “Linux Administration Software Installation Instructions,” on page 2 


¢ Section 3.2, “Windows Client Installation from the Linux Software Image,” on page 2 
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Linux Administration Software Installation Instructions 


IMPORTANT: If you are installing the GroupWise software in a cluster, refer to the GroupWise 2012 
Interoperability Guide for cluster-specific installation instructions before starting to install the 
GroupWise 2012 SP2 software. 


1 Download the GroupWise 2012 SP2 Administration compressed tar file to a temporary directory 
on your Linux server: 


gw1l2.0.2 full _linux_en.tar.gz 
gw1l2.0.2 full linux _multi.tar.gz 


2 Ina terminal window at your Linux server, change to the temporary directory, then use the 
following command to uncompress and untar the downloaded file: 


tar -xvzf file_name.tar.gz 
The files are extracted to the root of the directory. 
3 Become root by entering su - and the root password. 


4 Inthe directory where you extracted the GroupWise 2012 SP2 files, use the following command 
to start the GroupWise Installation program: 


./install 
5 Click Create or Update GroupWise System. 
6 Follow the on-screen instructions to install the GroupWise 2012 SP2 software. 


When you install a Support Pack, you can streamline the update process by using the Install 
option to install the updated RPM for each agent. Typically, you do not need to use the Configure 
option after installing updated agent software, if the agent configuration has not changed since 
the previous installation. If you encounter a problem starting the updated agent, use the 
Configure option to update the configuration information for the agent. 


Update the primary domain first. Start the MTA in the primary domain. Then update secondary 
domains, followed by the post offices in each domain. Start each MTA and POA for each domain 
and post office. Then update the other GroupWise agents. 


For additional installation instructions, see the GroupWise 2012 Installation Guide. 


Windows Client Installation from the Linux Software Image 


The GroupWise Windows client is included in the GroupWise 2012 SP2 Linux software image. 
To install the Windows client from the Linux image: 
1 On the Linux server where the GroupWise 2012 SP2 image is located, create a Samba share of the 
software distribution directory (/opt /novell/groupwise/software). 


2 On the Windows workstation where you want to install the GroupWise client, map a drive to the 
Samba share. 


3 Run setup.exe in the \\linux_server\samba_share\software\client directory, as 
described in “Installing the GroupWise Clients” in the GroupWise 2012 Installation Guide. 


For automated distribution of the GroupWise Windows client, SetupIP is also included in the Linux 
software image. For usage instructions, see “Using GroupWise AutoUpdate and SetupIP to 
Distribute the GroupWise Windows Client” in “Client” in the GroupWise 2012 Administration Guide. 
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Windows Installation 


+ 


+ 


Section 4.1, “Windows Administration and Agent Software Installation Instructions,” on page 3 


Section 4.2, “Windows Client Software Installation Instructions,” on page 3 


Windows Administration and Agent Software Installation 
Instructions 


IMPORTANT: If you are installing the GroupWise software in a cluster, refer to the GroupWise 2012 
Interoperability Guide for cluster-specific installation instructions before starting to install the 
GroupWise 2012 SP2 software. 
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Download the Windows GroupWise 2012 SP2 compressed executable file to a temporary 
directory on your Windows server: 


gw1l2.0.2 full _win_en.zip 
gw1l2.0.2 full _win_multi.zip 


Extract the . zip file into a directory at the root of your local drive or to a network server drive 
that can handle long path names 


The compressed file contains directory paths that could exceed DOS limits. 

In Windows Explorer, browse to the directory where you extracted the GroupWise 2012 SP2 file. 
Double-click setup.exe to run the GroupWise Installation program. 

Click Install GroupWise System. 

Follow the on-screen instructions to install the GroupWise 2012 SP2 software. 


When you install a Support Pack, you can streamline the update process by copying the updated 
agent software files but not configuring the agents again. In the Installation program, select 
Install the Software Files, But Do Not Configure the Agents on the Installation Path page when you 
install the POA, the MTA, and the GWIA. 


Update the primary domain first. Start the MTA in the primary domain. Then update secondary 
domains, followed by the post offices in each domain. Start each MTA and POA for each domain 
and post office. Then update the other GroupWise agents. 


For additional instructions, refer to the GroupWise 2012 Installation Guide on the GroupWise 2012 
Documentation Web site (http://www.novell.com/documentation/groupwise2012). 


Windows Client Software Installation Instructions 
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2 
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Download the GroupWise 2012 SP2 Windows Client compressed executable file to a temporary 
directory on your workstation: 


gw1l2.0.2 client _win_en.exe 
gw1l2.0.2 client _win_multi.exe 


In Windows Explorer, browse to the directory where you downloaded the GroupWise 2012 SP2 
Client compressed executable file. 


Double-click the downloaded file to extract the GroupWise client software and start the 
GroupWise client Setup program. 
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4 Follow the on-screen instructions to install the GroupWise 2012 SP2 client software on your 
workstation. 


The GroupWise Setup Progress dialog box displays a green bar during the installation process. 
Occasionally, long pauses might occur. You can also check the activity of the GroupWise client 
Setup program by viewing the Performance tab of the Windows Task Manager to observe CPU 
usage. 


Installation Issues 


+ Section 5.1, “General Installation Issues,” on page 4 
+ Section 5.2, “Linux Installation Issues,” on page 4 
+ Section 5.3, “Windows Installation Issues,” on page 6 


Installation issues for individual GroupWise components are located under the heading for each 
component. 


General Installation Issues 


Platform-specific installation issues are listed in separate sections below. Installation issues for 
individual GroupWise components are located under the heading for each component. 


+ Section 5.1.1, “GroupWise Version Compatibility,” on page 4 


GroupWise Version Compatibility 


If you install GroupWise on multiple platforms, or if you run multiple versions (for example, 
GroupWise 7 or 8 and GroupWise 2012 in the same GroupWise system), refer to “GroupWise Version 
Compatibility” in the GroupWise 2012 Installation Guide to make sure that the combinations you are 
using are supported. 


For example, you cannot run a GroupWise 2012 client against a GroupWise 8 or earlier post office. 
Earlier POAs cannot support later GroupWise clients. However, you can run a GroupWise 8 or earlier 
client against a GroupWise 2012 POA. 


Also, you should not run the GroupWise 8 or earlier snap-ins to ConsoleOne to access GroupWise 
2012 databases or eDirectory objects. You can use Admin Lockout Settings under Tools > GroupWise 
System Operations > System Preferences to specify the required version of the ConsoleOne snap-ins for 
each domain as needed. 


Linux Installation Issues 


¢ Section 5.2.1, “32-bit Runtime Libraries Required on 64-bit Linux,” on page 4 
è Section 5.2.2, “SLES Base System Installation Required,” on page 5 

è Section 5.2.3, “System Creation on SLES 11 in a Virtual Machine,” on page 5 
+ Section 5.2.4, “GroupWise Installation to a Xen Guest on SLES 10,” on page 5 


¢ Section 5.2.5, “eDirectory Reinstallation on Open Enterprise Server,” on page 5 


32-bit Runtime Libraries Required on 64-bit Linux 


When you install a Linux operating system for use with GroupWise, do not deselect the 32-bit 
runtime libraries. GroupWise requires the 32-bit runtime libraries. 
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SLES Base System Installation Required 


When you install SUSE Linux Enterprise Server (SLES) for use with GroupWise, select the Base 
System option. If you select the Minimal System (Appliances) option, the GroupWise Installation 
program prompts you to install additional packages to meet GroupWise dependencies. Although 
you can manually install the additional packages after installing SLES, it is simpler to install SLES so 
that all GroupWise dependencies are automatically met. 


System Creation on SLES 11 in a Virtual Machine 


When you run the Linux GroupWise Installation program and create a new GroupWise system in a 
virtual machine on SLES 11, the system creation process might crash with a Java exception. There are 
two workarounds: 


+ Configure the virtual machine with at least 4 GB of memory to avoid the problem. 


+ In ConsoleOne, delete the POA object that was created during GroupWise system creation, then 
create a new POA object. Install and configure the agents independent from creating the 
GroupWise system. 


GroupWise Installation to a Xen Guest on SLES 10 


When you install GroupWise on SLES 10 to a Xen guest, you might receive the following error 
message: 


The current window is not large enough to run install. Please resize the window and 
run install again. 


At present, the SLES 10 Xen console window does not report its dimensions properly. To work 
around this: 
1 Make sure that SSH is enabled on the Xen guest. 


2 Open an X terminal window on the SLES 10 Xen host, using the following command: 


ssh -X root@guest_ip address 


3 Run the GroupWise Installation program from the Xen host. 


eDirectory Reinstallation on Open Enterprise Server 


If you need to uninstall and reinstall eDirectory on Open Enterprise Server for Linux, your 
GroupWise system is affected, because the GroupWise objects in eDirectory are lost when eDirectory 
is uninstalled. Therefore, you need to re-create the GroupWise objects in the new eDirectory tree. 


1 (Conditional) If ConsoleOne has been uninstalled and reinstalled along with eDirectory, reinstall 
the GroupWise snap-ins to ConsoleOne, as described in “Installing the GroupWise 
Administrator Snap-Ins to Linux ConsoleOne” in “System” in the GroupWise 2012 Administration 
Guide. 


2 In ConsoleOne, extend the eDirectory schema for GroupWise objects, as described in “Check 
eDirectory Schema” in “System” in the GroupWise 2012 Administration Guide. 


3 Graft the GroupWise objects into the new eDirectory tree: 


3a Access the primary GroupWise domain directory, as described in “Select Domain” in 
“System” in the GroupWise 2012 Administration Guide. 


3b Graft your GroupWise domains and post offices into the new eDirectory tree, as described 
in “Graft GroupWise Objects” in “System” in the GroupWise 2012 Administration Guide. 
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For additional assistance, see TID 7004121, “How to Graft GroupWise Objects,” in the 
Novell Support Knowledgebase (http://www.novell.com/support). 


3c Graft in GroupWise users and other GroupWise objects that belong to post offices. 
4 Start all the GroupWise agents. 


Windows Installation Issues 


¢ Section 5.3.1, “Windows Server 2012 and eDirectory,” on page 6 

¢ Section 5.3.2, “Windows Client Installation in a 64-bit Environment,” on page 6 

+ Section 5.3.3, “Windows Security Rights for GroupWise Client Installation,” on page 7 

+ Section 5.3.4, “Can’t Launch the GroupWise Client from the Client Setup Program,” on page 7 
+ Section 5.3.5, “Norton Internet Security 2010 and SetupIP,” on page 7 


Windows Server 2012 and eDirectory 


GroupWise 2012 SP2 supports Windows Server 2012, but Novell eDirectory is not yet supported on 
Windows Server 2012. The updated eDirectory version is expected to release in mid-2013. 


In the meantime, the GroupWise 2012 SP2 agents can run on Windows Server 2012, but your 
eDirectory installation must remain on an earlier version of Windows or on Linux. 


Windows Client Installation in a 64-bit Environment 


The GroupWise Windows client is a 32-bit application. Microsoft indicates that it is not advisable to 
run 64-bit Office applications that use 64-bit MAPI in the same environment with 32-bit applications 
that use 32-bit MAPI. For background information, refer to Building MAPI Applications on 32-Bit and 
64-Bit Platforms (http://msdn.microsoft.com/en-us/library/dd941355.aspx). 


If you need to run the GroupWise client in the same environment with Microsoft Office, the 32-bit 
version of Office is recommended. If you prefer the 64-bit version of Office, GroupWise and Office do 
coexist successfully in the majority of environments. 


Very occasionally, you might encounter the following errors when you start the GroupWise client 
when 64-bit Office is also installed: 


* The ‘MAPI Session Handle’ of the Novell GroupWise ‘Object Request Broker’ could 
not be accessed. The address book cannot run. 


* GroupWise is not properly installed. The Address Book component could not be 
initialized. Please run GroupWise Setup, or contact your system administrator. 


To enable the GroupWise client to function correctly in these situations, use either of the following 
workarounds: 


+ Run the GroupWise client Setup program a second time, selecting Repair. 


or 


¢ Uninstall the GroupWise client, then reinstall it. 
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Similarly, you might very occasionally encounter the following errors if you start 64-bit Outlook: 


* Either there is no default mail client or the current mail client cannot 
fulfill the messages request. Please run Microsoft Outlook and set it as the 
default mail client. 


* Cannot start Microsoft Outlook. Cannot open the Outlook window. The set of 
folders cannot be opened. An unexpected error has occurred. MAPI was unable to 
load the information service gwmspl.dll. Be sure the service is correctly 
installed and configured. 


To enable Outlook to start correctly, do not select the Novell GroupWise Profile that is installed with 
the GroupWise Windows client. Instead, create a new profile as you start Outlook, so that the profile 
is compatible with 64-bit Outlook. 


Windows Security Rights for GroupWise Client Installation 


If the GroupWise Windows client is originally installed by the Windows Administrator user, the 
Administrator user must also perform software updates. When the client is installed by the 
Administrator, the GroupWise client software cannot be updated by a regular user or a Windows 
Power User. 


Can’t Launch the GroupWise Client from the Client Setup Program 


Starting in GroupWise 2012 SP1, you cannot launch the GroupWise client directly from the client 
Setup program. You must exit the client Setup program, then launch the GroupWise client. 


Norton Internet Security 2010 and SetupIP 


Older versions of Norton Internet Security 2010 incorrectly identify GroupWise SetupIP as a virus 
and automatically remove it while it is trying to install the GroupWise Windows client on a 
workstation. Symantec indicates that this problem is resolved by running LiveUpdate to obtain the 
latest version of Norton Internet Security 2010. If you still encounter the problem, you must disable 
Norton Internet Security 2010 before SetupIP can successfully run on a workstation. 


Administration Issues 


+ Section 6.1, “General Administration Issues,” on page 7 
+ Section 6.2, “Linux Administration Issues,” on page 9 


+ Section 6.3, “Windows Administration Issues,” on page 10 


General Administration Issues 


¢ Section 6.1.1, “GWCSRGEN Functionality,” on page 8 

¢ Section 6.1.2, “Server Names,” on page 8 

è Section 6.1.3, “Identity Manager Driver Version Compatibility,” on page 8 

è Section 6.1.4, “Identity Manager Driver in a 64-bit Environment,” on page 8 


è Section 6.1.5, “Server-Based Antivirus Software,” on page 9 
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6.1.1 GWCSRGEN Functionality 


In earlier versions of GroupWise, the GroupWise Generate CSR Utility (GWCSRGEN) created a 
certification signing request (CSR) that returned an MD5 (http://en.wikipedia.org/wiki/MD5) 
certificate. The MD5 algorithm is now considered compromised and should not be used. 


Starting in GroupWise 2012 SP1, GWCSRGEN creates a CSR that returns an SHA-1 (http:// 
en.wikipedia.org/wiki/SHA-1) certificate. The SHA-1 algorithm is more secure than MD5, but also 
has some potential weaknesses. 


For the most stringent security needs, GWCSRGEN should no longer be used for generating CSRs. 
For suggested alternatives, see “Generating a Certificate Signing Request” in “Security 
Administration” in the GroupWise 2012 Administration Guide. 


6.1.2 Server Names 


When filling in a UNC Path field in ConsoleOne, you must specify the server name. You cannot use an 
IP address or DNS hostname. 


6.1.3 Identity Manager Driver Version Compatibility 


Do not run a DirXML or Identity Manager driver earlier than version 3.5.2 against a GroupWise 2012 
system. Older drivers are not compatible. You can download the latest version of the GroupWise 
Identity Manager driver from Novell Downloads (http://download.novell.com). 


For more information, see TID 7002222: “How is the GroupWise Driver Configured for Identity 
Manager?” in the Novell Support Knowledgebase (http://www.novell.com/support). 


6.1.4 Identity Manager Driver in a 64-bit Environment 


The GroupWise 2012 product is comprised of many 32-bit services and applications. These pieces all 
run successfully on 64-bit hardware and operating systems. 


The Identity Manager driver for GroupWise is also a 32-bit application. It requires either a 32-bit 
version of the Identity Manager engine, or a 32-bit version of the Identity Manager Remote Loader. 
For most installations, we recommend deploying the 64-bit version of the Identity Manager engine 
on a 64-bit system, and then deploying the 32-bit Identity Manager Remote Loader along with the 
Identity Manager driver for GroupWise on a 32-bit system as described here. 

1 Set up a 32-bit server for use by the Identity Manager driver for GroupWise. 

2 Install and configure the Identity Manager Remote Loader on the 32-bit server. 

Follow the setup instructions for your version of Identity Manager: 


+ Identity Manager 4.0 Remote Loader Guide (http://www.novell.com/documentation/idm40/ 
idm_remoteloader/data/bookinfo.html) 


¢ Identity Manager 3.6.1 Remote Loader Guide (http://www.novell.com/documentation/idm36/ 
idm_remoteloader/data/bookinfo.html) 


3 Install and configure the Identity Manager driver for GroupWise on the same 32-bit server as the 
Identity Manager Remote Loader. 


Follow the setup instructions for your version of the Identity Manager driver for GroupWise: 


+ Identity Manager 4.0 Driver for GroupWise Implementation Guide (http://www.novell.com/ 
documentation/idm40drivers/groupwise/data/bktitle.html) 


+ Identity Manager 3.6 Driver for GroupWise Implementation Guide (http://www.novell.com/ 
documentation/idm36drivers/groupwise/data/bktitle.html) 
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In this configuration, the Identity Manager Remote Loader on the 32-bit server communicates 
successfully with the Identity Manager engine and with the GroupWise agents that are both running 
on 64-bit servers. 


Server-Based Antivirus Software 


If you run server-based antivirus software, you must configure it so that it does not scan GroupWise 
directory structures such as domains and post offices. Running antivirus software on GroupWise 
directory structures creates file locking conflicts with the GroupWise agents, which prevents email 
and administration messages from being delivered. 


If you need virus scanning on GroupWise data, check the GroupWise Partner Products page (http:// 
www.novell.com/partnerguide/section/468.html) for compatible products. 


Linux Administration Issues 


¢ Section 6.2.1, “NFS Not Supported,” on page 9 

+ Section 6.2.2, “SNMP Not Supported on 64-bit Linux Operating Systems,” on page 9 
+ Section 6.2.3, “GWTSAFS Discontinued,” on page 9 

+ Section 6.2.4, “Path Names and File Names in Lowercase,” on page 10 


+ Section 6.2.5, “Unavailable Administration Features,” on page 10 


NFS Not Supported 


Because of long-standing file lock issues with NFS, you cannot use an NFS mount to mount a server 
file system where your GroupWise system is located to a workstation where you are running 
ConsoleOne. In addition, you cannot use an NFS mount between Linux servers, for example when a 
POA needs access to a remote restore area or a remote document storage area. 


Use a Samba mount if you want to use Windows ConsoleOne to access a domain located on a Linux 
server. For access between Linux servers, use a Samba mount or an NCP (Novell Core Protocol) 
mount. For instructions to set up a Samba mount or an NCP mount, see “ConsoleOne Administration 
Tool” in “System” in the GroupWise 2012 Administration Guide. 


SNMP Not Supported on 64-bit Linux Operating Systems 


All GroupWise agents can be monitored through an SNMP management console. However, 64-bit 
Linux operating systems do not include the 32-bit components required for communication with the 
32-bit GroupWise engine. Therefore, SNMP monitoring of GroupWise agents is not currently 
available on 64-bit Linux operating systems. 


GWTSAEFS Discontinued 


GroupWise 2012 does not include GWTSAFS. The supported versions of Novell Open Enterprise 
Server (OES) provide TSAFS, which is the preferred backup approach moving forward. For more 
information, see “GroupWise Backup” in the Storage Management Services Administration Guide for 
your version of OES (http://www.novell.com/documentation/oes.html). 
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Path Names and File Names in Lowercase 


All directory names in paths to GroupWise domains and post offices should consist of lowercase 
letters. File names should also consist of lowercase letters. There are no length restrictions. 


However, on Open Enterprise Server (OES), when you create an NSS volume, the volume name 
automatically appears in all uppercase in the path name. Because the use of lowercase letters in 
directory names is recommended for convenience, but is not required by any GroupWise program, 
this behavior on OES does not present any problems for GroupWise. You simply need to remember 
to type the uppercase letters when you specify the path name on OES. 


Unavailable Administration Features 


GroupWise 2012 administration on Linux does not include the following features that are available in 
GroupWise 2012 on Windows: 


+ Import/Export utility in ConsoleOne 


+ Document Properties Management feature in ConsoleOne 


Windows Administration Issues 


+ Section 6.3.1, “eDirectory and Windows Support,” on page 10 
+ Section 6.3.2, “Domain Services for Windows Issue,” on page 10 


+ Section 6.3.3, “Quotas on NSS Volumes,” on page 10 


eDirectory and Windows Support 


Versions of Novell eDirectory earlier than 8.8.4 are not supported on Windows Server 2008. 


Domain Services for Windows Issue 


If you create a DSfW static group and then convert it to a GroupWise distribution list by assigning it 
to a post office, email messages addressed to the group are not delivered to GroupWise users. To 
correct the problem, synchronize the post office that owns the distribution list. In ConsoleOne, select 
the post office, then click Tools > GroupWise Utilities > Synchronize. 

Quotas on NSS Volumes 


If you use NSS volumes with quotas turned on, you must turn on quotas on all GroupWise 
directories. Otherwise, you receive No Disk Space errors. 


Agent Issues 


+ Section 7.1, “General Agent Issues,” on page 10 
¢ Section 7.2, “Linux Agent Issues,” on page 12 


+ Section 7.3, “Windows Agent Issues,” on page 12 


General Agent Issues 


+ Section 7.1.1, “SOAP Required for the POA,” on page 11 


¢ Section 7.1.2, “Incoming Message Size Limit,” on page 11 
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¢ Section 7.1.3, “New View Files Overwrite Existing View Files,” on page 11 


+ Section 7.1.4, “Audit Reports,” on page 11 


SOAP Required for the POA 


The GroupWise 2012 WebAccess Application communicates directly with the POA through SOAP. 
Therefore, the POA that the WebAccess Application is configured to communicate with must have 
SOAP enabled in order for WebAccess to function. For appropriate security, SSL should be enabled 
on the SOAP connection. 


For setup instructions, see the following sections in the GroupWise 2012 Administration Guide: 


+ “Supporting SOAP Clients” 
¢ “Securing the Post Office with SSL Connections to the POA” 


Incoming Message Size Limit 


When the GWIA receives an incoming message from the Internet, it creates a MIME version of the 
message that includes the message and any attached files. This doubles the size of the message. 


You can restrict message size at the GWIA, the MTA, and the POA. The message size that you set at 
the GWIA determines the maximum size of messages that are allowed into your GroupWise system. 
However, because of the way that the GWIA creates the MIME version of incoming messages, 
message size limits at the MTA and POA must be two to three times the size set at the GWIA. 
Otherwise, some messages can successfully enter your GroupWise system at the GWIA, but they 
cannot be delivered because of the size limits set at the MTA or the POA. 


When such a delivery failure occurs, no undeliverable message is sent, so no one is notified of the 
problem. 


New View Files Overwrite Existing View Files 


When you update the POA software to GroupWise 2012, updated view files are copied to the 
software distribution directory, but not to post offices. This maintains any customizations you might 
have made in the view files in post offices. 


However, when each GroupWise 2012 POA starts for the first time, it copies the new view files from 
the software distribution directory to its post office. Therefore, if you have created custom view files 
with the same names as standard view files, you must create backup copies before starting the 
GroupWise 2012 POA, so that your customized view files are not lost when the post office view files 
are updated. After you start the GroupWise 2012 POA, restore your custom view files. 


Occasionally, the POA is unable to copy the updated view files from the software distribution 
directory to its post office. When this happens, users receive a message that their view files are out of 
date. To resolve this, use the Refresh Views option under Tools > GroupWise Utilities > System 
Maintenance in ConsoleOne to update the post office view files from the software distribution 
directory. After you refresh the views, you must restore your customized view files to the post office. 


Audit Reports 


Whenever the POA runs an audit report, it causes the MTA for the domain to restart. In a domain 
with a large number of post offices, these MTA restarts might become noticeable. This is working as 
designed, although improved functionality has been requested. 
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Linux Agent Issues 


+ Section 7.2.1, “Non-root GroupWise Agents and Low Port Numbers,” on page 12 
+ Section 7.2.2, “Maximum Number of Open Files,” on page 12 


¢ Section 7.2.3, “Document Viewer Agent Issues,” on page 12 


Non-root GroupWise Agents and Low Port Numbers 


On Novell Open Enterprise Server and SUSE Linux Enterprise Server, services such as IMAP and 
IMAP SSL, which require port numbers below 1025, cannot be initiated or restarted after the 
GroupWise agents are running as a non-root user. To initiate or restart those services, you must 
manually stop the services and then restart the GroupWise agents. 


Maximum Number of Open Files 


By default, the maximum number of open files on a Linux server is 1024. This default might not be 
sufficient for a busy POA. Therefore, the POA initializes the maximum number of open files to 
200000. 


The default number of open files is typically acceptable for the other GroupWise agents. 


Document Viewer Agent Issues 


¢ If you run the Document Viewer Agent (DVA) as a user that is not running the X Window 
system, WebAccess users cannot view embedded vector-based graphics in attachments. To 
enable users to view embedded vector-based graphics, make sure that the user that starts the 
DVA is running the X Window System and has a DISPLAY environment variable set so that the 
DVA can write to the local display. One way to accomplish this is to use the sux command to 
become root before you start the DVA. 


¢ The third-party viewer software used by the DVA has a dependency on 1ibxXm.so.1, which 
might not be included with your Linux package. To resolve this, create a symbolic link in the 
agents lib directory to the version of the 1ibXm modules that is available on your Linux server. 
For example: 


In -s /usr/X11R6/1lib/libXm.so.3.0.1 /opt/novell/groupwise/ 
agents/lib/libXm.so.1 


Windows Agent Issues 


è Section 7.3.1, “POA Instability,” on page 12 


¢ Section 7.3.2, “Document Viewer Agent Issue,” on page 13 


POA Instability 


GroupWise 2012 SP1 included a fix for the problem where the Windows POA terminates 
unexpectedly and repeatedly when GroupWise Windows client users connect from outside of the 
firewall on the external client/server port. If you continue to see the problem after installing Support 
Pack 1 and later versions, add the /udpslap switch to the POA startup file. This switch is designed 
specifically to alleviate this particular connection issue. 
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Document Viewer Agent Issue 


If you run the Document Viewer Agent (DVA) on Windows Server 2008, and if you have not 
configured it to run as the Administrator user, you must use the /home switch in the gwdva. dva file 
to specify a directory where the DVA user can write files. You might want to create a 
c:\novell\groupwise\gwdva directory for this purpose. 


Client Issues 


+ 


+ 


Section 8.1, “Windows Client Issues,” on page 13 


Section 8.2, “Mac/Linux Client Issues,” on page 15 


Windows Client Issues 


+ 


+ 


+ 


+ 


Section 8.1.1, “SetupIP Programs Identified as Viruses,” on page 13 
Section 8.1.2, “New Speller,” on page 13 

Section 8.1.3, “Archiving over the Network,” on page 14 

Section 8.1.4, “Initial Cache Priming,” on page 14 

Section 8.1.5, “GroupWise/Vibe Compatibility,” on page 14 

Section 8.1.6, “GroupWise/iFolder Compatibility,” on page 14 
Section 8.1.7, “GroupWise/Filr Compatibility,” on page 14 

Section 8.1.8, “Windows XP and Power Users,” on page 14 


Section 8.1.9, “Address Books Do Not Display in GroupWise When Installing GroupWise after 
Outlook 2003,” on page 15 


Section 8.1.10, “Word 2010 Not Supported as the GroupWise Text Editor,” on page 15 
Section 8.1.11, “JAWS Script Available,” on page 15 


SetupIP Programs Identified as Viruses 


The setupip.exe and writeip.exe SetupIP programs are falsely identified as viruses by Norton 
Internet Security 2010. As a workaround, configure Norton Internet Security 2010 to ignore these 


files. 


New Speller 


The GroupWise 2012 Windows client uses a new speller engine technology named Hunspell. You 
should not notice any difference in the “spell-as-you-type” mode. However, there are a few features 
available in the old Spell Checker dialog box that are no longer available. 


+ 


+ 


+ 


When the Spell Checker dialog box opens, it immediately begins spell checking. 
You can no longer check spelling in a paragraph, sentence, or by word. 


You can no longer add or manage multiple personal word lists from the Spell Checker dialog 
box. There is only one personal word list. 
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Archiving over the Network 
The recommended location for a Windows client user’s archive is on his or her local workstation. 
Creating an archive on a network drive is supported in the following two configurations: 


¢ The Novell Map Network Drive feature of the Novell Client is used to map a network drive from 
the user’s workstation to a Novell Open Enterprise (OES) Linux server or a NetWare server 
where the archive is located. 


The OES Linux server must use NSS volumes, and you must use NCP access with cross-protocol 
locks enabled in order to ensure safe client access to the archive. The setup for Windows client 
access to an OES Linux server is the same as for Windows ConsoleOne access to an OES server. 
For setup instructions, see “Configuring the OES Linux Server for NCP Access from Windows” 
in “ConsoleOne Administration Tool” in the GroupWise 2012 Administration Guide. 


+ The Windows Map Network Drive feature is used to map a network drive from the user’s 
workstation to an OES Linux server using Novell CIFS access. 


Other configurations, including Samba on a SUSE Linux Enterprise Server (SLES) server, are not 
currently supported. 
Initial Cache Priming 


The first time you prime a new Caching mailbox, the GroupWise client might terminate at the end of 
the priming process. However, the Caching mailbox is successfully created. Restart the client to 
access the new Caching mailbox. 


GroupWise/Vibe Compatibility 


If you use Novell Vibe with GroupWise, Vibe 3 or later is required for GroupWise 2012 integration. 


GroupWisel/iFolder Compatibility 


Do not use iFolder with your GroupWise mailbox. For more information, see “GroupWise Files 
Become Corrupted in an iFolder” in “Troubleshooting” in the Novell iFolder Cross-Platform User Guide 
(http://www.novell.com/documentation/ifolderos/os_ifolder37_user/data/bookinfo.html). 


The issues involved with trying to use iFolder with GroupWise apply to using GroupWise with other 
directory synchronization applications such as Microsoft Offline Files. Do not use any of these 
applications with GroupWise. 


GroupWisel/Filr Compatibility 


Do not use Filr with your GroupWise mailbox. As with other directory synchronization applications, 
Filr does not respect the database locking mechanism employed by GroupWise. Creating a copy of a 
GroupWise database while it is in use can result in a corrupted database. This applies to your 
Caching mailbox and to your archive. 


Windows XP and Power Users 


If you are a member of the Power Users group when you install the GroupWise Windows client, you 
cannot immediately uninstall the GroupWise Windows client in the Control Panel. You must follow 
these steps to uninstall: 

1 Remove yourself from the Power Users group. 


2 Log out of Windows. 
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3 Log back in to Windows. 
4 Uninstall the GroupWise Windows client. 


Address Books Do Not Display in GroupWise When Installing GroupWise after Outlook 
2003 


If you install Outlook, then install GroupWise, then uninstall Outlook, you must reinstall GroupWise 
in order to restore MAPI, which is uninstalled along with Outlook. To avoid this problem, uninstall 
Outlook before you install GroupWise. 


Word 2010 Not Supported as the GroupWise Text Editor 


The GroupWise Windows client allows you to use Microsoft Word or OpenOffice.org as the text 
editor for composing messages. Microsoft Word 2010 is not currently supported, although earlier 
versions of Word are fully supported. Microsoft Word 2010 will be supported in a future GroupWise 
release. 


JAWS Script Available 


Users of the JAWS screen reader can install the JAWS script available for GroupWise. Follow the 
instructions in the \client\jaws\gw_jaws_readme.txt file to install the JAWS script and other files 
on your workstation. 


If you encounter Section 508 accessibility issues in the GroupWise 2012 Windows client, continue to 
use the GroupWise 8 Windows client. Section 508 accessibility issues will be addressed in a future 
GroupWise release. 


Mac/Linux Client Issues 


+ Section 8.2.1, “GroupWise 8 Mac/Linux Client with GroupWise 2012,” on page 15 

+ Section 8.2.2, “Indexing Limitation of the Mac Client in Caching Mode,” on page 15 
+ Section 8.2.3, “Sound Device Issue,” on page 16 

è Section 8.2.4, “Linux Client Package Dependencies,” on page 16 

+ Section 8.2.5, “Problem Displaying Flash Content in Web Panels,” on page 16 

¢ Section 8.2.6, “KDE Integration with the Linux Client,” on page 16 

+ Section 8.2.7, “Running as root in Caching Mode,” on page 16 

+ Section 8.2.8, “Archiving Over the Network,” on page 16 

+ Section 8.2.9, “No Progress Bar Displayed When a Database Is Rebuilt,” on page 16 


GroupWise 8 Mac/Linux Client with GroupWise 2012 


GroupWise 2012 does not include the Mac/Linux Client. The GroupWise 8 Mac/Linux client is 
compatible with GroupWise 2012. The GroupWise 8 SP2 HP 4 Mac client includes bug fixes for 
improved performance with GroupWise 2012. 


Indexing Limitation of the Mac Client in Caching Mode 


The new indexable file types of PDF, OpenOffice.org, and Microsoft Office 2007 are not indexed by 
the Mac client in Caching mode. The module that provides this functionality is not currently 
available on Mac. If you change to Online mode, the POA handles this indexing, so you can find these 
documents in Online mode. 
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8.2.9 


Sound Device Issue 


The Mac/Linux client currently requires exclusive access to the sound device in your workstation. As 
a result, if Notify is turned on and configured to play a sound for notifications or alarms, other 
programs cannot use the sound device as long as Notify is running. Novell is awaiting a Sun Java fix 
in order to resolve this problem. 


Linux Client Package Dependencies 


Depending on the Linux version on your workstation, you might need to install the following 
packages to resolve dependencies for the GroupWise Linux client: 


+ Open Motif 2.2 or later 
¢ The GIMP Toolkit (GTK) 2 or later 


+ libstdc++33 or later 


Typically, these packages are part of your base Linux operating system. 


Problem Displaying Flash Content in Web Panels 


In the GroupWise Linux client, if you display a Web page that includes Flash content, and if you have 
Adobe Flash Player 9 installed in your Web browser, the GroupWise Linux client might crash. Install 
the latest Service Pack for SUSE Linux Enterprise Desktop to resolve the problem. This Service Pack 
includes an updated version of Flash Player 9, where the problem no longer occurs. 


KDE Integration with the Linux Client 


By default, KDE applications like Konqueror do not launch the Linux GroupWise client when a 
mailto link is selected. To configure KDE applications to work with the GroupWise Linux client, see 
TID 7001213, “Configuring KDE Applications to Launch GroupWise” in the Novell Support 
Knowledgebase (http://www.novell.com/support). 


Running as root in Caching Mode 


If you run the Linux client in Caching mode as root, you might encounter synchronization problems 
with your master mailbox when you next run as a regular user. If pending requests from the root 
session remain when you log in as a regular user, regular user requests are backed up behind the 
root requests, which cannot be processed while you are logged in as a regular user. 


To resolve any problems, run the client as root again so that all messages are synchronized, then run 
as a regular user thereafter to prevent further problems. 


Archiving Over the Network 


The required location for a Mac/Linux client user’s archive is on his or her local workstation. Creating 
an archive on a network drive is not currently supported. 


No Progress Bar Displayed When a Database Is Rebuilt 


When you are prompted to rebuild your mailbox, there is no progress indicator displayed during the 
rebuild process. 
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WebAccess Issues 


+ Section 9.1, “General WebAccess Issues,” on page 17 
+ Section 9.2, “Linux WebAccess Issues,” on page 20 


+ Section 9.3, “Windows WebAccess Issues,” on page 20 


General WebAccess Issues 


+ Section 9.1.1, “WebAccess Time Zone,” on page 17 

+ Section 9.1.2, “Gray Page instead of WebAccess Login Window,” on page 17 
+ Section 9.1.3, “Shared Folder Notification Issue,” on page 18 

è Section 9.1.4, “Proxy Calendar Availability,” on page 18 

+ Section 9.1.5, “WebAccess Mobile and Tablet Issues,” on page 18 

+ Section 9.1.6, “WebPublisher Availability,” on page 19 

+ Section 9.1.7, “WebAccess Monitoring,” on page 19 


+ Section 9.1.8, “Preventing Web Server Directory Browsing,” on page 20 


WebAccess Time Zone 


In GroupWise 8 WebAccess, you needed to manually set the WebAccess time zone if you wanted 
WebAccess to use a time zone that was different from the time zone of your post office. In GroupWise 
2012, the WebAccess time zone automatically matches the time zone of your workstation. To change 
the WebAccess time zone, change your workstation time zone. 


Gray Page instead of WebAccess Login Window 


Occasionally, after you update the WebAccess software, the WebAccess URL displays a gray page 
instead of the WebAccess Login window. The problem occurs when you install multiple GroupWise 
Web applications in quick succession. It is possible for one Web application installation to be 
incomplete when the next one starts, which results in an unusable installation. 


To prevent the problem, display each Web application in your Web browser before you install the 
next application: 


http://web_server_address/gw/webacc 


http://web_server_address/gwcal/admin 
http://web_server_address/gwmon/gwmonitor 


To resolve the problem after it has occurred: 


1 Stop Tomcat. 


OES 2 and SLES 10 = rctomcat5 stop 
OES 11 and SLES 11 rctomcaté stop 


Windows 1. At the Windows server, click Start > Administrative Tools > Services. 


2. Right-click Tomcat 6, then click Stop. 


2 Remove the gw directory from the Tomcat installation. 
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Tomcat on OES 2: /var/opt/novell/tomcat5/webapps/gw 


Tomcat on SLES 10: /srv/www/tomcat5/base/webapps/gw 
Tomcat on OES 11: /var/opt/novell/tomcaté6/webapps/gw 
Tomcat on SLES 11: /usr/share/tomcat6/webapps/gw 
Tomcat on Windows c:\Novell\tomcaté\webapps\gw 


3 Restart Tomcat. 


OES 2 and SLES 10 = rctomcat5 start 
OES 11 and SLES 11 rctomcaté start 


Windows 1. At the Windows server, click Start > Administrative Tools > Services. 
2. Right-click Tomcat 6, then click Start. 


This re-creates the gw directory structure, which ensures that all files are correctly extracted from 
the gw. war file. 


Shared Folder Notification Issue 


Starting with GroupWise 2012, you can share folder trees. In the GroupWise Windows client, the 
shared folder notification for the folder tree arrives as a single notification. In WebAccess, you receive 
a shared folder notification for each folder in the shared folder tree. In a large folder tree, this could 
result in a large number of shared folder notifications. 


Multiple shared folder notifications for folder trees shared in GroupWise 2012 occur in GroupWise 8 
in both the Windows client and in WebAccess. 
Proxy Calendar Availability 


In the GroupWise Windows client, you can right-click a Calendar folder, then click New Proxy 
Calendar to display the Calendar of a proxy user as a sub-calendar in your own Calendar. 


In WebAccess, you cannot create a Proxy Calendar, and Proxy Calendars created in the Windows 
client do not display in WebAccess. In WebAccess, you must proxy to the other user’s mailbox in 
order to view that user’s Calendar. 


WebAccess Mobile and Tablet Issues 


è Section 9.1.5.1, “WebAccess Mobile on Android Tablets,” on page 19 

+ Section 9.1.5.2, “Attachments on a Samsung Galaxy Tablet,” on page 19 
+ Section 9.1.5.3, “PDF Display on an ASUS Tablet,” on page 19 

+ Section 9.1.5.4, “Browser Display on an ASUS Tablet,” on page 19 
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WebAccess Mobile on Android Tablets 
Android tablets that run Android 3.2 or later are supported for use with WebAccess Mobile. 


Many Android tablets that run Android 4.0 work well with WebAccess Mobile. However, some 
Android 4.0 tablets have device/OS-specific issues that might cause display, usability, or functionality 
challenges. Many of these issues have easy workarounds. However, some Android 4.0 tablets simply 
do not function as expected with WebAccess Mobile. Keeping device firmware updates current can 
help mitigate some of these challenges while Novell works to fully support Android 4.0. 


Attachments on a Samsung Galaxy Tablet 


On a Samsung Galaxy tablet, the Quickoffice HD location for attaching documents and text files 
might not be available, depending on the specific model of the Galaxy tablet. You can attach files in 
WebAccess Mobile only from locations that are available on your particular tablet. 


PDF Display on an ASUS Tablet 


PDF files cannot be displayed on ASUS Transformer TF101 and TF102 tablets. These tablets do not 
currently have a plug-in for displaying PDF files. As a result, the PDF file is downloaded to the tablet 
rather than being immediately displayed. To display a PDF file after it has been downloaded, use a 
native application like MyLibrary or Polaris Office to view it. 


Browser Display on an ASUS Tablet 
ASUS tablets have browser display issues in WebAccess Mobile, including: 
¢ Pages occasionally do not load. 


+ Pages might be very slow to load. 


¢ The browser quits. When it is relaunched, the browser does not display the pages and tabs that 
were originally displayed when it quit. 


+ Typing text in the browser is very slow. 
As a workaround: 
1 Enter the following text in the address bar: 


about : debug 


2 Inthe browser menu, click Settings > Debug. 
3 Deselect Enable OpenGL Rendering. 


4 Repeat this procedure each time you restart the tablet. 


WebPublisher Availability 


WebPublisher is not part of GroupWise 2012. To continue using WebPublisher, you must maintain a 
GroupWise 8 domain with GroupWise 8 WebAccess to support your WebPublisher needs until 
comparable functionality becomes available in the future. 


WebAccess Monitoring 


Starting in GroupWise 2012, the WebAccess Application communicates directly with the POA, and 
the WebAccess Agent is no longer needed. As a result, WebAccess cannot be monitored by 
GroupWise Monitor, because Monitor communicates with agents, not with Web applications. 
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Preventing Web Server Directory Browsing 


If your Web server is configured to allow directory browsing, a user can access the /com directory of 
your Web server and browse downward from there. There is no confidential information located in 
any of the directories that are accessible in this manner. 


However, if you want to prevent access, you can change the configuration of your Web server. For 
example, if you are using Apache, you can modify the httpd.conf file to remove the access that is 
provided by default. Locate the section that provides directory options for the htdocs directory. 
Either remove the Indexes option from the Options directive or place a minus (-) in front of it. 
Restart Apache to put the change into effect. 


Linux WebAccess Issues 


+ Section 9.2.1, “WebAccess Update Issue,” on page 20 


WebAccess Update Issue 


If you update an existing WebAccess installation to GroupWise 2012, you must use both the Install 
and Configure options in the GroupWise Installation program in order for the GroupWise 2012 
version of the WebAccess Application to be installed and configured correctly. If you do not run the 
Configure option, you continue to run the old WebAccess Application, not the GroupWise 2012 
version. 


Windows WebAccess Issues 


è Section 9.3.1, “Installation on 64-bit Windows Server 2008,” on page 20 
+ Section 9.3.2, “Novell iManager Compatibility on Windows,” on page 20 


+ Section 9.3.3, “Internet Explorer and Google Chrome Frame,” on page 21 


Installation on 64-bit Windows Server 2008 


On Windows, WebAccess requires ISAPI support. ISAPI support is no longer installed by default 
when you install Windows Server 2008 and Internet Information Services (IIS). Ideally, you should 
select ISAPI support during the installation of IIS. However, if you are installing WebAccess on 
Windows Server 2008 and ISAPI support is not yet installed, you can add it after the fact. 

1 In Windows Server Manager, expand Roles, then right-click Web Server (IIS). 

2 Inthe Role Services section, click Add Role Services. 

3 Select Application Development, select ISAPI Extensions and ISAPI Filters, then click Install. 


4 (Conditional) If you installed the GroupWise WebAccess Application before you installed ISAPI 
support, reinstall the GroupWise WebAccess Application. 


The WebAccess Installation program restarts Tomcat and IIS to put the ISAPI changes into effect. 


Novell iManager Compatibility on Windows 


Do not install WebAccess and Novell iManager on the same Windows 2003/2008 server. Because 
WebAccess installs and configures its own Tomcat and Jakarta connector, it must be installed on a 
server where Tomcat is not already in use by another program. If they are installed on the same 
server, either WebAccess or iManager does not work. 
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Internet Explorer and Google Chrome Frame 


In Internet Explorer 6 and 7, WebAccess relies on Google Chrome Frame in order to provide a variety 
of advanced features. If a user’s workstation does not have Google Chrome Frame, the user is 
prompted to download and install it from the Internet. If your WebAccess users do not have access to 
the Internet, you can make Google Chrome Frame available locally. 


1 Download the Google Chrome Frame installer from the following Web site: 


http: //www.google.com/chromeframe 


The Google Chrome Frame installer is named 
GoogleChromeframeStandaloneEnterprise.msi. 


2 Place the .msi file under the document root directory on your Web server. 
3 Test the location by viewing the URL for the file in your Web browser. 
4 Specify the URL for the Google Chrome Frame installer in the WebAccess configuration file: 
4a Edit the webacc.cfg file in an ASCII text editor. 
4b Add the following line at the bottom of the file: 
GoogleChromeFrame.url=installer_ location 
4c Replace installer_location with the URL that you tested in Step 3. 
4d Save the file and exit the text editor. 


5 Restart Tomcat. 


Internet Agent Issues 

+ Section 10.1, “General Internet Agent Issues,” on page 21 

¢ Section 10.2, “Linux Internet Agent Issues,” on page 22 

+ Section 10.3, “Windows Internet Agent Issues,” on page 22 
General Internet Agent Issues 

¢ Section 10.1.1, “Functionality of the --msstu Switch,” on page 21 


Functionality of the --msstu Switch 


The --msstu switch replaces spaces with underscores (_) in the email address of the sender, but not in 
the addresses of recipients. This is working as designed. 
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Linux Internet Agent Issues 


¢ Section 10.2.1, “Internet Agent Installation Security,” on page 22 


Internet Agent Installation Security 


During installation, the Linux Internet Agent Installation program requires access to eDirectory by 
way of LDAP authentication. The LDAP Group object includes an option named Require TLS for 
Simple Binds with Password, which is enabled by default. With this option enabled, you must provide 
the LDAP server’s trusted root certificate, which must be exported from the LDAP server, in order for 
LDAP authentication to take place (typically on port 636) during installation of the Internet Agent. 


Unless you already have SSL set up, an easier alternative is to disable Require TLS for Simple Binds with 
Passwords in ConsoleOne, which allows LDAP authentication to take place using clear text (typically 
on port 389), during installation of the Internet Agent. After disabling the option, restart eDirectory, 
install the Internet Agent, then re-enable Require TLS for Simple Binds with Password and restart 
eDirectory again. 


Windows Internet Agent Issues 


None. 


Calendar Publishing Host Issues 


è Section 11.1, “General Calendar Publishing Host Issues,” on page 22 
è Section 11.2, “Linux Calendar Publishing Host Issues,” on page 23 
¢ Section 11.3, “Windows Calendar Publishing Host Issues,” on page 23 


General Calendar Publishing Host Issues 


è Section 11.1.1, “Calendar Publishing Host Name Required During Installation,” on page 22 
+ Section 11.1.2, “Attachments Not Published,” on page 22 


Calendar Publishing Host Name Required During Installation 


The Calendar Publishing Host Installation program prompts for the name of the Calendar Publishing 
Host. If you are updating an existing Calendar Publishing Host installation, the Calendar Publishing 
Host name must match the name provided in ConsoleOne under Tools > GroupWise System Operations 
> Web Calendar Publishing Hosts. The name must be specified identically in both places, including 

spacing and capitalization. If the names do not match, the Calendar Publishing Host cannot function. 


Attachments Not Published 


If calendar items include attachments, the attachments are not published to the Web, but the calendar 
items themselves are still successfully published. 
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11.2 Linux Calendar Publishing Host Issues 


è Section 11.2.1, “Linux Calendar Publishing Host Issues Shared with WebAccess,” on page 23 


11.2.1 Linux Calendar Publishing Host Issues Shared with WebAccess 


The Calendar Publishing Host and WebAccess share a substantial amount of functionality. The 
following WebAccess issue also pertains to the Calendar Publishing Host: 


Section 9.2.1, “WebAccess Update Issue,” on page 20 


11.3 Windows Calendar Publishing Host Issues 


None. 


12 Monitor Issues 


è Section 12.1, “General Monitor Issues,” on page 23 
* Section 12.2, “Windows Monitor Issues,” on page 23 


+ Section 12.3, “Linux Monitor Issues,” on page 23 
12.1 General Monitor Issues 
è Section 12.1.1, “Monitor Agent SSL Configuration,” on page 23 


12.1.1 Monitor Agent SSL Configuration 


If you want to enable SSL by using the Monitor Agent /httpssl and /httpcertfile switches, the 
certificate file must be in PEM format. This differs from the other GroupWise agents, which take a 
.b64 public certificate file and a .key private key file. The PEM format combines the certificate and 
key in a single file. 


12.2 Windows Monitor Issues 


None. 


12.3 Linux Monitor Issues 
+ Section 12.3.1, “Linux Monitor Issues Shared with WebAccess,” on page 23 


¢ Section 12.3.2, “Restoring Monitor Settings after Reinstallation,” on page 24 


12.3.1 Linux Monitor Issues Shared with WebAccess 


Monitor and WebAccess share a substantial amount of functionality. The following WebAccess issue 
also pertains to Monitor: 


Section 9.2.1, “WebAccess Update Issue,” on page 20 
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Restoring Monitor Settings after Reinstallation 


Monitor settings are stored in the monitor .xm1 file in the Monitor installation directory. Agent 
groups are also stored in this file. If you reinstall the Monitor software, the monitor .xm1 file is 

backed up as monitor .001. To restore previous Monitor settings and agent groups, remove the 
newly installed monitor .xml file and rename monitor .001 to monitor.xml. 


GroupWise/Exchange Coexistence Issues 


The GroupWise/Exchange coexistence solution is available starting in GroupWise 2012 SP2. 


+ Section 13.1, “General GroupWise/Exchange Coexistence Issues,” on page 24 
¢ Section 13.2, “Address Book Synchronization Issues,” on page 24 


+ Section 13.3, “GroupWise Free/Busy Service Issues,” on page 26 


General GroupWise/Exchange Coexistence Issues 


è Section 13.1.1, “Pre-existing GroupWise/Exchange Synchronization,” on page 24 


Pre-existing GroupWise/Exchange Synchronization 


If you have been using the legacy GroupWise Gateway for Microsoft Exchange or another method for 
connecting your GroupWise and Exchange systems, you must consider how to handle information 
that has already been synchronized before you implement the coexistence solution provided in 
GroupWise 2012 SP2. For a list of considerations, see Appendix A, “Preexisting GroupWise/ 
Exchange Synchronization” in the GroupWise/Exchange Coexistence Guide. 


Address Book Synchronization Issues 


è Section 13.2.1, “Address Book Synchronization Licensing,” on page 24 

+ Section 13.2.2, “Names for the GroupWise External Domain and Post Office Objects,” on page 25 
+ Section 13.2.3, “Shared Internet Domain Names,” on page 25 

+ Section 13.2.4, “Object Names with Spaces,” on page 25 


+ Section 13.2.5, “Checking Free/Busy information on GroupWise Users in a Distribution Group,” 
on page 25 


+ Section 13.2.6, “Unsupported GroupWise Send Options,” on page 25 


Address Book Synchronization Licensing 


When you enable address book synchronization in ConsoleOne, you receive the following 
notification: 


Exchange address book synchronization requires its own license. 
If you enable Exchange address book synchronization, 
your GroupWise system might be subject to additional licensing fees. 


We invite you to contact your Novell representative, reseller, or partner 
to learn more about this feature or for pricing and licensing information. 


Make sure that you understand the licensing fees that might apply before you implement address 
book synchronization. 
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Names for the GroupWise External Domain and Post Office Objects 


After address book synchronization, Exchange objects are organized under an External Domain 
object, which is located under the GroupWise System object in ConsoleOne. The original Active 
Directory context of each object is represented by an External Post Office object. The External Post 
Office object cannot have the same name as the External Domain object. 


Shared Internet Domain Names 


If you want your GroupWise system and your Exchange system to have the same Internet domain 
name (for example, novell .com), some specialized configuration is required. For background 
information, see Configure Exchange 2012 to Route Messages for a Shared Address Space (http:// 
technet.microsoft.com/en-us/library/bb676395.aspx). 

1 Edit the Accepted Domain for the Organization Hub Transport Accepted domain. 

2 Change it to an Internal Relay Domain. 

3 Create a new Send Connector. 


4 Configure it to relay by setting its SMTP Address Space to the GWIA IP address or DNS 
hostname. 


5 Configure the MX record for the shared Internet domain name to point to the Exchange system, 
which then forwards non-local addresses to the GWIA in the GroupWise system. 


Object Names with Spaces 


During the synchronization process, GroupWise and Exchange object names become part of email 
addresses. The space character is not valid in email addresses. As a result, objects with spaces in their 
names do not synchronize because their email addresses are invalid. 


Exchange prevents the creation of invalid email addresses. For GroupWise, you must set up a 
preferred email ID for each object that would, by default, have an invalid email address. For more 
information, see “Object Naming Consideration” in “GroupWise/Exchange Address Book 
Synchronization” in the GroupWise/Exchange Coexistence Guide. 


Checking Free/Busy information on GroupWise Users in a Distribution Group 


The current version of the GroupWise Free/Busy service does not provide free/busy information for 
groups. 


If you use the Scheduling Assistant in Outlook, you see free/busy information from GroupWise users 
in a group only if you expand the group. 


In Outlook WebAccess, you cannot expand the group. Therefore, you cannot see free/busy 
information for GroupWise users in the group, and you might get an error. 

Unsupported GroupWise Send Options 

The following GroupWise send options were supported by the legacy GroupWise Exchange Gateway 


but are not supported in the GroupWise/Exchange coexistence solution: 
¢ Classification (Normal, Proprietary, Confidential, Secret, Top Secret, For Your Eyes Only) 
+ Reply Requested (When Convenient, With nn Days) 
+ Delay Delivery 
¢ Notify Recipients 
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If users select these send options in GroupWise, the options have no effect on messages sent to 
Exchange users. 


GroupWise Free/Busy Service Issues 


+ Section 13.3.1, “Passwords for the Free/Busy Service User Accounts,” on page 26 


+ Section 13.3.2, “GroupWise User Display in the Outlook Suggested Times Box,” on page 26 


Passwords for the Free/Busy Service User Accounts 


If the passwords for the Free/Busy service user accounts that access the GroupWise and Exchange 
systems change for any reason, the Free/Busy service can no longer obtain free/busy information. 
Ideally, set up these user accounts to be exempt from password expiration rules. If these account 
passwords need to change for any reason, run the Free/Busy Configurator to provide the current 
passwords to the Free/Busy service. 


GroupWise User Display in the Outlook Suggested Times Box 


In the Outlook Scheduling Assistant, GroupWise users’ schedules are correctly listed as you add 
attendees to the appointment. However, the Suggested Times box cannot determine the availability 
of GroupWise users. 


International Issues 


è Section 14.1, “General International Issues,” on page 26 
¢ Section 14.2, “Linux International Issues,” on page 28 


* Section 14.3, “Windows International Issues,” on page 29 


General International Issues 


+ Section 14.1.1, “SMS Texting and European Phone Numbers,” on page 26 

+ Section 14.1.2, “Double-Byte Character Restrictions,” on page 27 

+ Section 14.1.3, “Linux Agent Server Consoles,” on page 27 

è Section 14.1.4, “Published Calendars with Extended Characters in File Names,” on page 27 
* Section 14.1.5, “Double-Byte Characters in WebAccess Mobile,” on page 27 

+ Section 14.1.6, “Arabic Display of Help in Internet Explorer 9,” on page 28 

+ Section 14.1.7, “Hebrew Not Available,” on page 28 


SMS Texting and European Phone Numbers 


GroupWise cannot correctly identify a country code in a phone number when there is no delimiter 
between the country code and the rest of the phone number. For example, if +49 is the country code, 
and if you enter a contact phone number as +491234567890, an SMS text message to that contact is 
undeliverable. If you put a space or a dash between the country code and the phone number, such as 
+49 1234567890, the SMS text message is successfully delivered. 


Sending SMS text messages from GroupWise is free of charge for senders. However, in some 
European countries, recipients must pay a small charge when they receive SMS text messages. 
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Double-Byte Character Restrictions 


+ Do not use double-byte characters in directory names and file names. 


+ Do not use double-byte characters in user passwords. The Change GroupWise Password dialog 
box in ConsoleOne currently allows entry of double-byte characters. However, the GroupWise 
client login does not allow entry of double-byte characters in passwords, so a user who was 
assigned a password with double-byte characters in ConsoleOne cannot type the double-byte 
characters when attempting to log in to GroupWise. 


Linux Agent Server Consoles 


If you start an individual GroupWise agent in a language other than English with a command like the 
following: 


./gwmta --show @provo.mta 
you must turn off UTF-8 in order for the agent server console to display properly. 
To turn off UTF-8 for the Linux server: 


1 In YaST, click System > Language > Details. 

2 Deselect UTF-8 Encoding, then click OK. 

3 Click Accept to save the new setting, then reboot the Linux server. 
If you do not want to turn off UTF-8 for the server, you can use the grpwise script to start the agents, 
because it turns off UTF-8 automatically when it starts the agents with the user interface provided by 
the --show switch. However, by default, the grpwise script starts the agents as daemons, without the 
user interface. To configure the grpwise script to start the agents with the user interface, see “Starting 


the Linux Agents as Daemons” in “Installing GroupWise Agents” in the GroupWise 2012 Installation 
Guide. 


Published Calendars with Extended Characters in File Names 


On Windows, Mozilla-based browsers such as Firefox do not handle extended character file names 
correctly for published calendars. This is a browser problem, not a GroupWise problem. There is no 
workaround. 


In Safari on Macintosh, extended character file names are not interpreted correctly. As a workaround, 
use Firefox instead of Safari to display published calendars. This is a browser problem, not a 
GroupWise problem. 


Double-Byte Characters in WebAccess Mobile 


¢ Section 14.1.5.1, “Login Window,” on page 27 
+ Section 14.1.5.2, “Name Completion,” on page 28 
+ Section 14.1.5.3, “Attached Files,” on page 28 


Login Window 


On some tablets, garbage characters display in the WebAccess Mobile Login window instead of 
readable text. This problem tends to occur on older devices, even when they are running a supported 
tablet operating system. 
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Name Completion 


On tablets, the process for inputting double-byte characters varies. The Name Completion feature in 
WebAccess Mobile does not work correctly when recipient names include double-byte characters. 


Two workarounds are available: 


+ Click User Lookup, then browse to the recipient. 


+ Type the first few characters of the user’s email address. Email addresses do not include double- 
byte characters. Therefore, the Name Completion feature can always complete the email 
address. 


Attached Files 

On some tablets, when you select a file with double-byte characters in the file name, the characters 
display as garbage characters. This is a problem with the device. 

Arabic Display of Help in Internet Explorer 9 

In WebAccess, the online help does not display correctly in Arabic. To correct the problem, enable 
Compatibility View by clicking Tools > Compatibility View. 

Hebrew Not Available 


Hebrew was dropped from the list of supported languages in GroupWise 8 SP1. 


Linux International Issues 


è Section 14.2.1, “Double-Byte Character Display in the Linux Client on SLED 11,” on page 28 
è Section 14.2.2, “Display Problem with Agent Server Console Interfaces,” on page 28 

è Section 14.2.3, “Russian Keyboard,” on page 29 

+ Section 14.2.4, “Mnemonics for Arabic, Hebrew, and Double-Byte Languages,” on page 29 

+ Section 14.2.5, “Localized Agent User Interface Display,” on page 29 


Double-Byte Character Display in the Linux Client on SLED 11 


If you run the Linux client on SUSE Linux Enterprise Desktop (SLED) 11, Chinese, Japanese, and 
Korean characters display incorrectly. You must meet the Linux client system requirements and 
install SLED 11 Service Pack 1 in order for double-byte characters to display correctly. 

Display Problem with Agent Server Console Interfaces 


If you run the Linux GroupWise agents with an agent console interface in languages other than 
English, the logging information might not display correctly. The problem occurs if your language 
encoding is set to UTF-8. 


To determine your current language encoding, use the following command in a terminal window: 
locale 
You can change your language encoding in YaST: 


1 Start YaST, click System, then double-click Choose Language. 


2 Select the language you are running the agents in, then click Details. 
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3 Deselect Use UTF-8 Encoding, then click OK. 
4 Stop and then restart the agents to put the new setting into effect. 


Russian Keyboard 


When you use a Russian keyboard, the Linux environment variables that provide language and 
locale information are usually set to ru_RU. Typically, this setting implies the Russian character set 
ISO-8859-5. However, on some distributions of Linux, the ISO-8859-5 character set must be set 
explicitly in order for your Russian keyboard to work with the GroupWise Mac/Linux client. Use the 
following command to specify the character set along with the language and locale information: 


export LANG=ru_RU.ISO-8859-5 


In most cases, setting the LANG environment variable also sets all LC_* environment variables and 
resolves all Russian keyboard problems. If you set the LANG environment variable and your Russian 
keyboard still does not work, use the following command to view the current settings for the LANG 
and LC_* environment variables: 


locale 

If any of the LC_* environment variables have not inherited the ISO-8859-5 specification, export them 
individually. 

Mnemonics for Arabic, Hebrew, and Double-Byte Languages 


Keyboard mnemonics for menu items work for characters a-z and A-Z, but not for other characters. 


Localized Agent User Interface Display 


The Linux GroupWise agent user interfaces display correctly if the Linux environment is using the 
ISO-8859-1 character set, which is the default for the GroupWise administration languages and 
locales. 


Language Character Set Code 
French fr_FR 

German de_DE 

Portuguese pt_BR 

Spanish es ES 


If the Linux environment is using a different character set encoding, such as UTF-8 (for example, 
fr_FR.UTF-8), the localized agent user interfaces do not display correctly. 


Windows International Issues 


¢ Section 14.3.1, “Installation Error about the component.msi File,” on page 30 


¢ Section 14.3.2, “Unwanted Language Selection Dialog Box during AutoUpdate of the 
GroupWise Windows Client Software,” on page 30 


+ Section 14.3.3, “Novell Vibe Folders in the GroupWise Windows Client,” on page 30 
¢ Section 14.3.4, “GWCSRGEN Utility Does Not Start in Spanish,” on page 30 
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Installation Error about the component.msi File 


When you update WebAccess, the Calendar Publishing Host, or Monitor, if you install the 
multilanguage version over the English-only version or vice versa, you receive the following 
message: 


The feature you are trying to use is on a network resource that is unavailable. 


Click OK to try again, or enter an alternate path to a folder containing the 
installation package ‘component.msi’ in the box below. 


Simply click Cancel. This is an automatic InstallShield message. The GroupWise Installation program 
correctly handles the situation without your assistance. 

Unwanted Language Selection Dialog Box during AutoUpdate of the GroupWise Windows 
Client Software 


Setting ShowDialogs=No in the setup.cfg file does not suppress the interface language dialog box 
that appears when you install the GroupWise Windows client from the multilanguage GroupWise 
software image. The interface language dialog box is displayed by InstallShield to ask what language 
the GroupWise Client Setup program should run in. It does not affect which client languages are 
installed by the Client Setup program. 


To suppress the interface language dialog box: 
1 Edit the following file in a text editor: 
software_distribution_directory\client\win32\setup.ini 
2 Locate the following line: 


EnableLangDia=Y 


3 Change Y to N. 
4 Save the setup. ini file, then exit the text editor. 
Novell Vibe Folders in the GroupWise Windows Client 


Files with certain extended and double-byte characters in their file names cannot be dragged into 
Novell Vibe folders. The problem is resolved in Novell Vibe 3.3. 


GWCSRGEN Utility Does Not Start in Spanish 


On a Windows server running the Spanish version of Windows, the GWCSRGEN utility does not 
start successfully. Use the English version of GWCSRGEN instead. GWCSRGEN runs successfully on 
other language versions of Windows. 


Documentation Issues 


+ Section 15.1, “General Documentation Issues,” on page 30 
+ Section 15.2, “Linux Documentation Issues,” on page 31 


+ Section 15.3, “Windows Documentation Issues,” on page 31 


General Documentation Issues 


None. 
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Linux Documentation Issues 


¢ Section 15.2.1, “Agent Help Does Not Display When the Agent Runs as a Non-root User,” on 
page 31 
Agent Help Does Not Display When the Agent Runs as a Non-root User 


When you start the Linux POA, the Linux MTA, and the Linux Internet Agent by using the --show 
switch to display a GUI user interface, if the agents are running as a non-root user, clicking Help does 
not display the agent help file. Help is displayed in a browser window and the agents currently 
launch the browser as root. Giving the user access to the browser window as root would be a 
security risk. This is working as designed. 


Windows Documentation Issues 


¢ Section 15.3.1, “PDF Display in Firefox,” on page 31 


PDF Display in Firefox 


Starting in Firefox 19, Firefox includes a built-in PDF viewer by default. In earlier versions, Adobe 
Acrobat has been used with Firefox. 


The built-in Firefox PDF viewer does not include the ability to expand and collapse the table of 
contents bookmarks in the left panel of PDF guides. In a large GroupWise guide, this expand/ 
collapse functionality can be very useful. 


To configure Firefox to use Adobe Acrobat as it did in previous versions: 


1 Click Firefox > Options > Applications. 
2 In Portable Document Format (PDF) field, select Use Adobe Acrobat (in Firefox), then click OK. 


GroupWise Bug Fixes 


GroupWise 2012 SP2 includes all bug fixes that are available in GroupWise 2012 SP1 and HP1. For a 
list of the bugs that have been fixed in GroupWise 2012 SP2, see the GroupWise 2012 SP2 Bug Fix List. 


GroupWise Documentation 


All GroupWise 2012 documentation is available at the GroupWise 2012 Documentation Web site 
(http://www.novell.com/documentation/groupwise2012). 


Each GroupWise 2012 guide lists the documentation updates that have occurred for Support Pack 2: 


+ “Documentation Updates” in the GroupWise 2012 Installation Guide 

+ “Documentation Updates” in the GroupWise 2012 Administration Guide 
In addition to the GroupWise product documentation, the following resources provide additional 
information about GroupWise 2012: 

¢ Novell Support and Knowledgebase (http://www.novell.com/support) 

+ GroupWise Support Forums (http://forums.novell.com/forumdisplay.php? &f=356) 

¢ GroupWise Cool Solutions (http://www.novell.com/communities/coolsolutions/gwmag) 


+ GroupWise Best Practices wiki (http://wiki.novell.com/index.php/GroupWise) 
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18 Legal Notices 


Novell, Inc. makes no representations or warranties with respect to the contents or use of this 
documentation, and specifically disclaims any express or implied warranties of merchantability or 
fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication 
and to make changes to its content, at any time, without obligation to notify any person or entity of 
such revisions or changes. 


Further, Novell, Inc. makes no representations or warranties with respect to any software, and 
specifically disclaims any express or implied warranties of merchantability or fitness for any 
particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of 
Novell software, at any time, without any obligation to notify any person or entity of such changes. 


Any products or technical information provided under this Agreement may be subject to U.S. export 
controls and the trade laws of other countries. You agree to comply with all export control 
regulations and to obtain any required licenses or classification to export, re-export, or import 
deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists 
or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not use 
deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. Please refer to 
the Novell International Trade Services Web page (http://www.novell.com/info/exports/) for more 
information on exporting Novell software. Novell assumes no responsibility for your failure to obtain 
any necessary export approvals. 


Copyright © 2012-2013 Novell, Inc. All rights reserved. No part of this publication may be 
reproduced, photocopied, stored on a retrieval system, or transmitted without the express written 
consent of the publisher. 


For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/ 
company/legal/trademarks/tmlist.html). 


All third-party trademarks are the property of their respective owners. 
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